home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / os2 / nortutil.zip / Ddate.txt < prev    next >
Text File  |  1996-08-30  |  3KB  |  129 lines
  1.  
  2.  
  3.  
  4.         DDATE(1) Emperor Norton Utilities DDATE(1)
  5.  
  6.  
  7. NAME
  8.     ddate - converts Gregorian dates to Discordian dates
  9.  
  10. SYNOPSIS
  11.     ddate [+format] [date]
  12.  
  13. DESCRIPTION
  14.     ddate prints the date in Discordian date format.
  15.  
  16.     If called with no arguments, ddate will get the current
  17.     system date, convert this to the Discordian date format
  18.     and print this on the standard output. Alternatively, a
  19.     Gregorian date may be specified on the command line, in
  20.     the form of a numerical day, month and year.
  21.  
  22.     If a format string is specified, the Discordian date will
  23.     be printed in a format specified by the string. This mech-
  24.     anism works similarly to the format string mechanism of
  25.     date(1), only almost completely differently. The fields
  26.     are:
  27.  
  28.      %A Full name of the day of the week (i.e., Sweetmorn)
  29.  
  30.      %a Abbreviated name of the day of the week (i.e., SM)
  31.  
  32.      %B Full name of the season (i.e., Chaos)
  33.  
  34.      %b Abbreviated name of the season (i.e., Chs)
  35.  
  36.      %d Ordinal number of day in season (i.e., 23)
  37.  
  38.      %e Cardinal number of day in season (i.e., 23rd)
  39.  
  40.      %H Name of current Holyday, if any
  41.  
  42.      %N Magic code to prevent rest of format from being
  43.         printed unles today is a Holyday.
  44.  
  45.      %n Newline
  46.  
  47.      %t Tab
  48.  
  49.      %X Number of days remaining until X-Day. (Not valid if
  50.         the SubGenius options are not compiled in.)
  51.  
  52.      %{
  53.  
  54.      %} Used to enclose the part of the string which is to
  55.         be replaced with the words "St. Tib's Day" if the
  56.         current day is St. Tibb's Day.
  57.  
  58.      %. Try it and see.
  59.  
  60.  
  61. EXAMPLES
  62.      % ddate
  63.      Sweetmorn, Bureaucracy 42, 3161 YOLD
  64.  
  65.      % ddate +'Today is %{%A, the %e of %B%}, %Y. %N%nCelebrate %H'
  66.      Today is Sweetmorn, the 42nd of Bureaucracy, 3161.
  67.  
  68.      % ddate +"It's %{%A, the %e of %B%}, %Y. %N%nCelebrate %H" 26 9 1995
  69.      It's Prickle-Prickle, the 50th of Bureaucracy, 3161.
  70.      Celebrate Bureflux
  71.  
  72.      % ./ddate +'Today's %{%A, the %e of %B%}, %Y. %N%nCelebrate %H' 29 2 1996
  73.      Today's St. Tib's Day, 3162.
  74.  
  75.  
  76. AUTHOR
  77.  Original program by Druel the Chaotic aka Jeremy Johnson
  78.  (mpython@gnu.ai.mit.edu)
  79.  Major rewrite by Le H:. O:. Smith, KYTP, aka Andrew
  80.  Bulhak (acb@zikzak.net)
  81.  Five tons of flax.
  82.  
  83. NOTE
  84.     I changed the default output to include an X-Day countdown and
  85.     included a little random blurb (the +%. option).  I also inserted
  86.     more entries from the SubG lexicon.  Compiled for SubG-Inside compliance.
  87.     New default output:
  88.     % ddate
  89.     Today is Prickle-Prickle, the 20th day of Bureaucracy in the YOLD 3162
  90.     677 days til X-Day      Keep the Lasagna flying!
  91.  
  92.     --Cary
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  50 Bureaucracy 3161 2
  129.